home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-03 / addnums.zip / ADDNUMS.DOC < prev    next >
Text File  |  1990-09-13  |  6KB  |  100 lines
  1.  
  2.   -= ADDNUMS =- Number Inserter
  3.  
  4.   Version 1.00  09/05/86
  5.   Version 1.01  09/12/90  P.D.Q. changes.
  6.  
  7.   (C) Copyright 1985, 1990 by William D. Hileman
  8.                               Route 3, Box 467
  9.                               Trenton, FL  32693
  10.                               (904) 463-1680
  11.  
  12.                           and Knowledge Applied Technologies, Inc.
  13.                               502 NW 75th Street, Suite #214
  14.                               Gainesville, FL 32607
  15.  
  16.      Released to the Public Domain for distribution free of charge.
  17.   The user is welcome to freely distribute this software, provided it
  18.   is distributed in its original form, and that there is no compensation
  19.   for the distribution.
  20.  
  21.      ADDNUMS is a program written for the latest Microsoft BASIC compilers.
  22.   ADDNUMS is a utility which reads an ASCII text file and inserts line numbers
  23.   before each logical line starting with line number one (1).  Any line which
  24.   ends with an underscore character (_) will not have the following line
  25.   numbered, as this is the BASIC character which denotes a continuation of a
  26.   logical line.  This line number insertion utility allows better debugging of
  27.   a BASIC program since a source program with no line numbers, while generally
  28.   preferred for it's better structure and appearance, does not return error
  29.   line numbers with it's error code.  As a matter of fact, if there are no
  30.   line numbers at all, not even the error code will be reported in any
  31.   coherent way - a major problem with the Microsoft/IBM BASIC compilers.
  32.   Adding line numbers to your BASIC program with this utility will help
  33.   pin-point the problem down to the logical line number.  Note that if your
  34.   program does indeed contain one or more logical line numbers, you may have
  35.   to edit the '.NUM' file before compiling.
  36.  
  37.      ADDNUMS can be invoked by entering 'ADDNUMS' and pressing [ENTER].
  38.   When started in this manner, ADDNUMS will prompt for a source filename.
  39.   The format for the source filename is the same as the command line format
  40.   described later.  Pressing [ENTER] without any filename will abort and exit
  41.   to DOS.  ADDNUMS will then search for the file.  If the file does not exist,
  42.   an error message is displayed, otherwise the output file will be created
  43.   with the extension '.NUM'.  The default extension for the source file is
  44.   '.BAS'.  If the source file has no extension, include a period or this
  45.   program will automatically append the 'BAS'.
  46.  
  47.      ADDNUMS can also be invoked with the source filename on the command
  48.   line by entering in the format 'ADDNUMS [d:][\path\]filename[.ext]', and
  49.   pressing [ENTER], where '[d:]' is the optional drive letter followed by a
  50.   colon, '[\path\]' is the optional directory path, 'filename' is the re-
  51.   quired one to eight-character name of the file, and '.ext' is the optional
  52.   one to three-character file extension preceded by a period.  If the ex-
  53.   tension happens to be '.NUM', the file will not be processed, since that is
  54.   the file that would have been created for output.  This type of invocation
  55.   by-passes the request for the source file name and goes straight through the
  56.   file integrity check covered earlier, and then produces the output file with
  57.   the extension '.NUM'.
  58.  
  59.      Finally, ADDNUMS can be invoked with a question mark on the command
  60.   line by entering 'ADDNUMS ?' and pressing [ENTER].  This causes ADDNUMS
  61.   to display a one-page description of the program with acceptable command
  62.   line formats displayed.  You will find this option available on most of
  63.   my utilities.
  64.  
  65.      I hope you can find some use of this utility.  I use it rather fre-
  66.   quently, as I almost exclusively write BASIC programs with little or no
  67.   line numbers, and find that with my being human, most do not run the first
  68.   time.
  69.  
  70.      I ask for no donations for my software, I write programs for a living
  71.   eight hours (plus) a day, and do these because I enjoy it.  These are my
  72.   small contributions to the public domain, mostly dedicated to the numerous
  73.   sysops I've encountered who feel no sacrifice in donating their priceless
  74.   time, effort, and equipment for our usage.  If you do find one of my
  75.   programs interesting or useful, or have an objective criticism, by all
  76.   means, please drop me a line.  I'd rather receive comments on my programs
  77.   than a few dollars contribution any day!
  78.  
  79.      Look for my other public domain software:
  80.  
  81.          IBC.ZIP      - A one to four-player simulation game.
  82.          TAB2SPC.ZIP  - Utility to expand TAB characters in text files
  83.          ADDNUMS.ZIP  - Utility to insert line numbers in a BASIC program
  84.          LOWCASE.ZIP  - Utility to convert upper to lower case in text files.
  85.          FLASH.ZIP    - Library of Turbo PASCAL routines.
  86.          TFL.ZIP      - Text file lister (to printer).
  87.          PAGEDISP.ZIP - Text slide-show maker.
  88.          MAKEMRG.ZIP  - Text merge file maker.
  89.          UUDOS.ZIP    - User Un-friendly DOS with Sound Blaster support.
  90.          TMORE.ZIP    - Like DOS's 'TYPE xxxxxxxx.xxx | MORE', but better.
  91.          ADIR.ZIP     - Like DOS's DIR, but shows attributes.
  92.          PUSHPOP.ZIP  - Routines to save and restore current drive & directory.
  93.  
  94.      IBC, TAB2SPC, ADDNUMS, LOWCASE, TFL, MAKEMRG, and UUDOS are written in
  95.   Microsoft BASIC.  FLASH, and PAGEDISP, are written in Borland Turbo PASCAL
  96.   3.0.  TMORE, ADIR, and PUSHPOP are written in Borland Turbo C.  CHKMEM is
  97.   written in Borland Turbo PASCAL, and Microsoft BASIC 7.0 using Crescent
  98.   Software's P.D.Q. libraries.  All include source, documentation, and
  99.   run-time files.
  100.